@esbuild-kit/esm-loader
Advanced tools
Package description
@esbuild-kit/esm-loader is an npm package that allows you to use ES modules (ESM) in Node.js environments that do not natively support them. It leverages esbuild to transpile and load ESM code, making it easier to work with modern JavaScript syntax and features.
Transpile ESM to CommonJS
This feature allows you to import and use CommonJS modules in an ESM context. The code sample demonstrates how to use the `createRequire` function to require a CommonJS module in an ESM file.
import { createRequire } from 'module';
const require = createRequire(import.meta.url);
const { exampleFunction } = require('./example-file.js');
exampleFunction();Load TypeScript files
This feature allows you to directly import and use TypeScript files in your Node.js project. The code sample shows how to import a TypeScript file and call a function from it.
import { exampleFunction } from './example-file.ts';
exampleFunction();Support for JSX/TSX
This feature enables you to import and use JSX/TSX files in your Node.js project. The code sample demonstrates how to import a TSX file and render a React component.
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(<App />, document.getElementById('root'));ts-node is a TypeScript execution engine and REPL for Node.js. It allows you to run TypeScript code directly without precompiling. Compared to @esbuild-kit/esm-loader, ts-node focuses more on TypeScript execution and less on ESM support.
babel-register is a package that hooks into Node.js require to compile files on the fly using Babel. It supports a wide range of JavaScript syntax and features. While it provides similar functionality to @esbuild-kit/esm-loader, it relies on Babel instead of esbuild for transpilation.
esm is a package that enables ES module support in Node.js. It allows you to use ESM syntax in Node.js versions that do not natively support it. Compared to @esbuild-kit/esm-loader, esm is more focused on providing ESM support without additional transpilation features.
Readme
Node.js loader for loading TypeScript files.
node: import prefixestsconfig.json pathsProtip: use with cjs-loader or tsx
esm-loader only transforms ES modules (
.mjs/.mtsextensions or.jsfiles inmoduletype packages).To transform CommonJS files (
.cjs/.ctsextensions or.jsfiles incommonjstype packages), use this with cjs-loader.Alternatively, use tsx to handle them both automatically.
npm install --save-dev @esbuild-kit/esm-loader
Pass @esbuild-kit/esm-loader into the --loader flag.
node --loader @esbuild-kit/esm-loader ./file.ts
The following properties are used from tsconfig.json in the working directory:
strict: Whether to transform to strict modejsx: Whether to transform JSX
Warning: When set to
preserve, the JSX syntax will remain untransformed. To prevent Node.js from throwing a syntax error, chain another Node.js loader that can transform JSX to JS.
jsxFactory: How to transform JSXjsxFragmentFactory: How to transform JSX FragmentsjsxImportSource: Where to import JSX functions fromallowJs: Whether to apply the tsconfig to JS filespaths: For resolving aliasestsconfig.json pathBy default, tsconfig.json will be detected from the current working directory.
To set a custom path, use the ESBK_TSCONFIG_PATH environment variable:
ESBK_TSCONFIG_PATH=./path/to/tsconfig.custom.json node --loader @esbuild-kit/esm-loader ./file.ts
Modules transformations are cached in the system cache directory (TMPDIR). Transforms are cached by content hash so duplicate dependencies are not re-transformed.
Set environment variable ESBK_DISABLE_CACHE to a truthy value to disable the cache:
ESBK_DISABLE_CACHE=1 node --loader @esbuild-kit/esm-loader ./file.ts
Yes. This loader transpiles JSON modules so it's also compatible with named imports.
Node.js has built-in support for network imports behind the --experimental-network-imports flag.
You can pass it in with esm-loader:
node --loader @esbuild-kit/esm-loader --experimental-network-imports ./file.ts
In ESM, import paths must be explicit (must include file name and extension).
For backwards compatibility, this loader adds support for classic Node resolution for extensions: .js, .json, .ts, .tsx, .jsx. Resolving a index file by the directory name works too.
import file from './file' // -> ./file.js
import directory from './directory' // -> ./directory/index.js
ESM import resolution expects explicit import paths, whereas CommonJS resolution expects implicit imports (eg. extensionless & directory imports).
As a result of this change, Node.js changes how it imports a path that matches both a file and directory. In ESM, the directory would be imported, but in CJS, the file would be imported.
To use to the CommonJS resolution algorithm, use the --experimental-specifier-resolution=node flag.
node --loader @esbuild-kit/esm-loader --experimental-specifier-resolution=node ./file.ts
tsx - Node.js runtime powered by esbuild using @esbuild-kit/cjs-loader and @esbuild-kit/esm-loader.
@esbuild-kit/cjs-loader - TypeScript & ESM to CJS transpiler using the Node.js loader API.
FAQs
Unknown package
We found that @esbuild-kit/esm-loader demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A threat actor on BreachForums is selling an unverified npm vulnerability for account takeover, but npm has not officially confirmed the existence of this security concern.
Security News
Cyber insurance rates are dropping as the market matures, according to a new report projecting global premiums to reach $43 billion by 2030, driven by international market uptake and growth in the SME sector.
Research
Security News
Socket researchers unpack a typosquatting package with malicious code that logs keystrokes and exfiltrates sensitive data to a remote server.